4.3 - 二次開發API

GoMinerProxy 的API文檔(v1.1.0版本,如部分新版功能未能更新可瀏覽器F12進行分析)


描述:登錄

請求URL:http://<domain_name>:<port>/api/auth/login

請求方式:POST

參數:

參數名 必選 類型 說明
password string 登錄密碼

返回示例:

{
    "code": 200,
    "expire": "2022-01-01T00:00:00+08:00",
    "token": "**********"
}

返回參數說明:

參數名 類型 說明
code int 200:為成功;400:為失敗
expire int64 token過期時間
token string Json Web Token,鑒權用

備注:Json Web Token過期時間為1天,超時后需重新登錄獲取


描述:獲取主頁信息

請求URL:http://<domain_name>:<port>/api/pool/dashboard

請求方式:GET

參數:

Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token

參數名 必選 類型 說明
Authorization string 登錄時獲取的token,填寫:Bearer[空格]Token

返回示例:

{
    "activeProxyCount": ***,
    "minerCount": ***,
    "processedJobs": *******,
    "processedSubmits": *******,
    "startTime": **********,
    "totalHashrate": ********
}

返回參數說明:

參數名 類型 說明
activeProxyCount int 活躍代理池數
minerCount int 在線礦機數
processedJobs int64 已分配任務數
processedSubmits int64 已提交貢獻數
startTime int64 時間戳,服務端開啟時間
totalHashrate int64 總算力(單位H/s)

備注:


描述:獲取服務器設置信息

請求URL:http://<domain_name>:<port>/api/pool/setting

請求方式:GET

參數:

Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token

參數名 必選 類型 說明
Authorization string 登錄時獲取的token,填寫:Bearer[空格]Token

返回示例:

{
    "password": "********",
    "version": "*******",
    "webPort": 9998
}

返回參數說明:

參數名 類型 說明
password string 登錄密碼
version string 當前服務端版本號
webPort int 網頁使用的端口

備注:


描述:獲取公告信息

請求URL:http://<domain_name>:<port>/api/pool/announcement

請求方式:GET

參數:

Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token

參數名 必選 類型 說明
Authorization string 登錄時獲取的token,填寫:Bearer[空格]Token

返回示例:

{
    "raw": "********"
}

返回參數說明:

參數名 類型 說明
raw string markdown格式的公告信息

備注:


描述:獲取代理池列表

請求URL:http://<domain_name>:<port>/api/pool/proxyList

請求方式:GET

參數:

Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token

參數名 必選 類型 說明
Authorization string 登錄時獲取的token,填寫:Bearer[空格]Token

返回示例:

[
    {
        "activeMinerCount": *,
        "name": "************",
        "pool": {
            "domain": "****************",
            "name": "**********"
        },
        "port": *****,
        "running": true
    }
]

返回參數說明:

參數名 類型 說明
activeMinerCount int 該代理池目前鏈接的礦機數
name string 該代理池名稱
pool-domain string 該代理池代理的礦池域名
pool-name string 該代理池代理的礦池名稱
port int 該代理池的端口
running boolean 該代理池的運行狀態

備注:


描述:獲取可代理的礦池列表

請求URL:http://<domain_name>:<port>/api/pool/upperPeers

請求方式:GET

參數:

Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token

參數名 必選 類型 說明
Authorization string 登錄時獲取的token,填寫:Bearer[空格]Token

返回示例:

[
    {
        "domain": "eth.f2pool.com",
        "id": 0,
        "name": "魚池"
    }
]

返回參數說明:

參數名 類型 說明
domain string 代理的礦池域名
id int 代理的礦池ID
name string 代理的礦池名稱

備注:


描述:獲取代理池配置信息

請求URL:http://<domain_name>:<port>/api/pool/proxy/config?name=<proxy_name>

請求方式:GET

參數:

Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token

參數名 必選 類型 說明
Authorization string 登錄時獲取的token,填寫:Bearer[空格]Token

返回示例:

{
    "name": "*****",
    "listenPort": ****,
    "poolIndex": *,
    "reconnectDelay": *,
    "feeLogic": *,
    "fees": [
        {
            "loginName": "*************************",
            "workerName": "****",
            "fee": *
        }
    ]
}

返回參數說明:

參數名 類型 說明
name string 該代理池的名稱
listenPort int 該代理池的端口
poolIndex int 上游礦池ID,可以從upperPeer獲取
reconnectDelay int 抽水延遲,暫未使用,默認0
feeLogic int 抽水邏輯,1:單礦機平均抽水;3:單礦機隨機抽水
fees-loginName string 該代理池抽水錢包地址
fees-workerName string 該代理池抽水礦機名
fees-fee int 該代理池抽水的比例(單位:千分之一)

備注:


描述:獲取代理池鏈接的礦機信息

請求URL:http://<domain_name>:<port>/api/pool/proxy/miners?name=<proxy_name>

請求方式:GET

參數:

Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token

參數名 必選 類型 說明
Authorization string 登錄時獲取的token,填寫:Bearer[空格]Token

返回示例:

[
    {
        "address": "***.***.***.***:*****",
        "connectTime": **********,
        "feeSubmits": **,
        "hashrate": *******,
        "lastSubmitDelay": *,
        "loginName": "************************",
        "submits": ***,
        "workerName": "***"
    }
]

返回參數說明:

參數名 類型 說明
address string 礦機的IP地址和端口
connectTime int64 礦機的連接時間戳
feeSubmits int64 礦機的抽水份額
hashrate int64 礦機的算力
lastSubmitDelay int 提交延遲
loginName string 礦機錢包地址
submits int64 礦機的提交份額
workerName string 礦機名

備注:


描述:獲取服務器運行日志

請求URL:http://<domain_name>:<port>/api/pool/logs

請求方式:GET

參數:

Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token

參數名 必選 類型 說明
Authorization string 登錄時獲取的token,填寫:Bearer[空格]Token

返回示例:

{
    "logs": [
        {
            "message": "*****************************************",
            "prefix": "****",
            "time": *********,
            "type": 0
        }
    ]
}

返回參數說明:

參數名 類型 說明
message string 一行日志的具體信息
prefix string 一行日志的關鍵程度
time int64 一行日志的時間戳
type int 一行日志的類型

備注:


描述:創建代理池

請求URL:http://<domain_name>:<port>/api/pool/proxy/create

請求方式:POST

請求示例:

{
    "feeLogic": 3,
    "fees": [
        {
            "fee": 15,
            "loginName": "gominerproxy",
            "workerName": "test"
        }
    ],
    "listenPort": 60004,
    "name": "test",
    "poolIndex": 0,
    "reconnectDelay": 0
}

參數:

參數名 必選 類型 說明
feeLogic string 抽水邏輯,1:單礦機平均抽水;3:單礦機隨機抽水
fees-fee int 該代理池抽水的比例(單位:千分之一)
fees-loginName string 該代理池抽水錢包地址
fees-workerName string 該代理池抽水礦機名
listenPort int 該代理池的端口
name string 該代理池的名稱
poolIndex int 上游礦池ID,可以從upperPeer獲取
reconnectDelay int 抽水延遲,暫未使用,默認0

Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token

參數名 必選 類型 說明
Authorization string 登錄時獲取的token,填寫:Bearer[空格]Token

返回示例:

{
    "code": 0,
    "error": null
}

返回參數說明:

參數名 類型 說明
code int 0:成功;1:失敗
error string 錯誤原因

備注:


描述:刪除代理池

請求URL:http://<domain_name>:<port>/api/pool/proxy/delete?name=<proxy_name>

請求方式:POST

請求示例:

{
    "name": "test"
}

參數:

參數名 必選 類型 說明
name string 該代理池的名稱

Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token

參數名 必選 類型 說明
Authorization string 登錄時獲取的token,填寫:Bearer[空格]Token

返回示例:

{
    "code": 0,
    "error": null
}

返回參數說明:

參數名 類型 說明
code int 0:成功;1:失敗
error string 錯誤原因

備注:


描述:啟動代理池

請求URL:http://<domain_name>:<port>/api/pool/proxy/start?name=<proxy_name>

請求方式:POST

Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token

參數名 必選 類型 說明
Authorization string 登錄時獲取的token,填寫:Bearer[空格]Token

返回示例:

{
    "code": 0,
    "error": null
}

返回參數說明:

參數名 類型 說明
code int 0:成功;1:失敗
error string 錯誤原因

備注:


描述:停止代理池

請求URL:http://<domain_name>:<port>/api/pool/proxy/stop?name=<proxy_name>

請求方式:POST

Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token

參數名 必選 類型 說明
Authorization string 登錄時獲取的token,填寫:Bearer[空格]Token

返回示例:

{
    "code": 0,
    "error": null
}

返回參數說明:

參數名 類型 說明
code int 0:成功;1:失敗
error string 錯誤原因

備注:


results matching ""

    No results matching ""